$Id: README,v 1.5 1998/07/20 22:50:28 ericb Exp $
Copyright (C) 1997 - 1998, Hewlett-Packard Company, all rights reserved.
Written by Eric Backus

This is the README file for the eavesdrop example directory.

This directory contains source code to three example programs.

The first program, "tput", sets up a measurement on multiple E143x
input modules, and has them send the data over both the VXI local bus,
and the VXI backplane.  It sets up an E1562 to read the local-bus data
and send it to disk.  It also reads the data from the VXI backplane
and plots this data to windows on an X11 display.

As is always the case with local bus, all modules must be in
contiguous slots in the VXI mainframe, with the E1562 module on the
right of all the input modules.  This example program assumes that the
first E143x module specified on the command-line is the left-most one
(this module must generate local bus data rather than append local bus
data).

The default for "tput" is to use a single E143x module at logical
address 8, and send the data to an E1562 module at logical address
144.  These can be changed on the command-line.

The second program, "tputresamp", is much like the "tput" program.
The difference is that this program sets up a resampling measurement.
The measurement requires an E143x module that has the tach board
option, and a tachometer signal should be hooked to the first tach
channel.

The data going to the VXI local bus (which gets saved to the E1562
disk) will be continuous raw time data from the E143x modules.  The
data going to the host computer (which gets plotted in the X11
windows) will be either raw time data or resampled time data,
depending on a command-line option.  The data going to the host
computer will be RPM armed, so no data will show up unless the tach
signal RPM value is changing.  The program arms every 100 RPM, in a
run-up from 700 RPM to 6000 RPM.

The third program, "pbck", uses the E1562 to read data from a disk,
and plot the data to windows on an X11 display.

For help in running these example programs, use the command-line
option "-u" to get a summary of the command-line options that the
program understands.

For more detailed information about the programs, see the comments at
the top of the source files tput.c, tputresamp.c, and pbkc.c.
